Walkthrough

This PR establishes foundational infrastructure for a Seoul-based bus tracking application by introducing location services, Bluetooth connectivity to bus-mounted devices, real-time bus arrival APIs, alert management, and a complete onboarding and home view. Includes comprehensive unit tests and configuration updates.

Changes

Sequence Diagram(s)

sequenceDiagram
    autonumber
    actor User
    participant HomeView
    participant LocationManager
    participant BusStopService
    participant BusArrivalService
    participant AlertManager
    participant BluetoothManager
    
    User->>HomeView: App opens or requests refresh
    HomeView->>LocationManager: requestPermission() / refreshLocation()
    LocationManager->>User: Request location permission
    User-->>LocationManager: Grant permission
    LocationManager->>LocationManager: Start tracking location
    LocationManager-->>HomeView: currentLocation updated
    
    HomeView->>BusStopService: getNearbyStations(location)
    BusStopService-->>HomeView: [StationItem] or error
    alt Success
        HomeView->>HomeView: Find nearest stop, find arrivals
        HomeView->>BusArrivalService: getStationArrivalInfo(arsId)
        BusArrivalService-->>HomeView: [BusArrivalItem] or error
    else OutOfSeoul / API Error
        HomeView->>AlertManager: showAlert(outOfSeoul/apiError)
        AlertManager-->>HomeView: Display alert
    end
    
    User->>HomeView: Select bus route
    HomeView->>HomeView: Update selected route state
    User->>HomeView: Tap "send courtesy-seat notification"
    HomeView->>BluetoothManager: sendCourtesySeatNotification(busNumber)
    BluetoothManager->>BluetoothManager: Scan for bus device
    BluetoothManager->>BluetoothManager: Connect & write message
    BluetoothManager-->>HomeView: Success/failure callback
    HomeView->>AlertManager: showAlert(success or error)
    HomeView->>HomeView: Reset selection

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

• Areas requiring extra attention:
  • BluetoothManager.swift — Multi-delegate pattern (CBCentralManagerDelegate, CBPeripheralDelegate) with state machine across scanning/connecting/writing; error paths and timeout logic need validation.
  • HomeView.swift (Presentation) — Dense async/await flows with three managers interacting; state transitions (location→station→arrivals→Bluetooth) and error handling across multiple alert types.
  • BusArrivalResponse.swift — Route type classification logic (BusRouteType.from) with heuristics for Korean bus number patterns; ensure all bus type mappings are correct.
  • LocationManager.swift — Permission state machine (notDetermined/authorized/denied) and one-time callback logic; verify CLLocationManager delegate lifecycle.
  • Info.plist configuration keys — Verify all mandatory keys (API_KEY, Bluetooth UUIDs) are provided; fatalError fallback in BluetoothConfig and AppConfig.

Possibly related issues

• Error 핸들링/Alert 추가 #19 — AlertManager with prioritized alert types (outOfSeoul, apiError, bluetoothUnsupported/unauthorized, locationUnauthorized) and settings navigation directly addresses error-handling and alert system requirements.

Possibly related PRs

• [Feat] 광진구 버스 종합, 위치 기반 버스 정류장 검색 기능 구현 #1 — Modifies same core files (LocationManager, BusStop/StopWithRoutes models, BusStopManager, test targets) at the code level.
• [Feat] ESP32와의 BLE 통신 구현 #7 — Overlapping BLE integration (BluetoothConfig, BluetoothManager, Info.plist BLE keys).
• [Feat] BLE 통신 iOS 초안 구현 #5 — Both add BLE integration (BluetoothManager, sendCourtesySeatNotification) and HomeView wiring for courtesy-seat notifications.

Suggested reviewers

• jinny3824

Poem

🐰 A rabbit hops through Seoul's busy streets,
With Bluetooth hops and location beats,
Bus stops now visible, alerts so clear,
Courtesy messages floating near!
From splash to home, the UI's grown,
Tests passing strong in hopper's zone! 🚌✨

Pre-merge checks and finishing touches

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}